加载中

OpenList 从零搭建到域名部署完整教程

yuyuovo 80

OpenList 从零搭建到域名部署完整教程
一键聚合你的所有网盘：阿里云盘、百度网盘、OneDrive、天翼云盘等 40+ 存储服务

前言
OpenList 是 AList 的社区驱动分支，旨在提供一个开源、安全、长期维护的网盘聚合解决方案。相比原版 AList，OpenList 更注重社区治理和安全性，适合想要自建私有云盘服务的用户。

本文目标：带你完成从服务器准备、Docker 部署、到绑定域名、配置 HTTPS 的完整流程，预计耗时 15-30 分钟。

一、准备工作

服务器/环境要求

系统：Linux（Ubuntu/Debian/CentOS 均可）或 NAS（群晖、绿联、飞牛等）
配置：最低 1核1G，推荐 2核2G 以上
软件：Docker 20.10+ 和 Docker Compose 2.0+
域名：一个已备案（国内服务器）或未备案（海外服务器）的域名
网络：服务器需开放 5244 端口（或你自定义的端口）

检查 Docker 环境

docker –version
docker-compose –version
如果未安装，请先安装 Docker：

Ubuntu/Debian 一键安装

curl -fsSL https://get.docker.com | bash
二、部署 OpenList（推荐 Docker Compose 方式）
方式一：Docker Compose 部署（推荐）
创建项目目录：

mkdir -p /opt/openlist
cd /opt/openlist
创建 docker-compose.yml 文件：

vim docker-compose.yml
粘贴以下配置（可根据需要修改端口和路径）：

services:
openlist:
image: ‘openlistteam/openlist:latest’
container_name: openlist
user: ‘0:0’ # 使用 root 权限运行，如需其他用户请修改
volumes:
– ‘./data:/opt/openlist/data’ # 配置文件和数据
– ‘./share:/opt/openlist/share’ # 可选：共享文件目录
ports:
– ‘5244:5244’ # 左侧可改为其他端口，如 8080:5244
environment:
– UMASK=022
– TZ=Asia/Shanghai

可选：预设管理员密码（否则随机生成）

– OPENLIST_PASSWORD=your_secure_password

restart: unless-stopped
启动服务：

docker-compose up -d
查看日志获取初始密码：

docker logs -f openlist
看到类似输出即表示成功：

Successfully created the admin user and the initial password is: xxxxxxxx
方式二：一键脚本安装（适合 Linux 小白）
如果你使用的是纯净 Linux 服务器，可以使用官方一键脚本：

curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh && sudo bash install-openlist-v4.sh
按提示选择 1 安装，脚本会自动处理依赖和配置。

三、基础配置与访问

首次登录

浏览器访问：http://你的服务器IP:5244

默认账号：admin
默认密码：查看 Docker 日志获取（或脚本安装时显示）
立即修改密码：登录后 → 右上角「管理员」→ 「个人设置」→ 修改密码。

防火墙设置

确保服务器防火墙放行端口：

Ubuntu/Debian (UFW)

sudo ufw allow 5244/tcp

CentOS (Firewalld)

sudo firewall-cmd –permanent –add-port=5244/tcp
sudo firewall-cmd –reload

云服务器安全组：在控制台添加 5244 端口入站规则

四、绑定域名与 HTTPS（关键步骤）

域名解析

在你的域名服务商（如 Cloudflare、阿里云、腾讯云）添加 A 记录：

主机记录：pan 或 openlist（子域名，也可使用主域名 @）
记录值：你的服务器 IP 地址
TTL：默认即可
等待 5-10 分钟让 DNS 生效。

反向代理配置（Nginx）

安装 Nginx：

sudo apt install nginx -y
创建站点配置文件：

sudo vim /etc/nginx/sites-available/openlist
粘贴以下配置（将 yourdomain.com 替换为你的域名）：

server {
listen 80;
server_name yourdomain.com; # 或 pan.yourdomain.com

location / {
proxy_pass http://127.0.0.1:5244;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;